home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #12 / Amiga Plus CD - 2002 - No. 12.iso / Tools / Freeware / ttengine-5.0 / font_database.readme next >
Text File  |  2002-04-28  |  3KB  |  76 lines
  1. 'ttrender.database' file format
  2.  
  3. 'ttrender.database' is a plain text file containing informations about
  4. TrueType fonts available in the system. There is no tool to
  5. automatically generate it, the database have to be written by hand.
  6. Every line contains one keyword followed by parameter value. Name and
  7. value can be separated by space(s) or equality sign, exactly the same as
  8. shell command parameters (to say more - database is parsed by the same
  9. ReadArgs() system call as shell command parameters are). Parameter
  10. values containing spaces should be quoted. Here are some examples:
  11.  
  12. FAMILYNAME Tahoma
  13. FAMILYNAME=Times
  14. FAMILYNAME = "Times New Roman"
  15. FAMILYNAME "Weird Font"
  16.  
  17. Keywords
  18.  
  19. FAMILYNAME - defines the name used for font opening. All variants of the
  20. font (italic, bold, black, heavy, light, demi etc.) will have the same
  21. family name.
  22.  
  23. ALIAS - defines another name for the same family. It generally has three
  24. purposes:
  25.  
  26. 1. Similar names for the same font, like "Times", "TimesNewRoman" and
  27. "Times New Roman".
  28.  
  29. 2. One replacement font for some very similar ones, for example
  30. "Helvetica" and "Switzerland" can be aliased to "Arial".
  31.  
  32. 3. Generic names like "default", "serif", "sans-serif", "monospaced". An
  33. application can request generic name without specific family name, or
  34. generic font can be used as a fallback if given name can't be found in
  35. the database. For example you can alias "monospaced" to "Courier", and
  36. an application (be it CSS compatible HTML viewer) can request
  37. 'LucidaConsole, monospaced'. If there is no LucidaConsole font in the
  38. system, Courier will be used. The same way you can alias any font to any
  39. other, for example Times to Arial, this makes not much sense however.
  40. "default" font will be used as a last resort.
  41.  
  42. REGULAR - specifies the path to *.ttf file containing regular flavour of
  43. the typeface.
  44.  
  45. ITALIC - specifies the path to *.ttf file containing italic or oblique
  46. flavour of the typeface.
  47.  
  48. BOLD - specifies the path to *.ttf file containing emboldened flavour of
  49. the typeface
  50.  
  51. BOLDITALIC - specifies the path to *.ttf file containing emboldened and
  52. italic (or oblique) flavour of the typeface.
  53.  
  54. If SHEAR keyword is used with one of the four above (makes sense with
  55. ITALIC and BOLDITALIC) the given font will be algorythmically sheared.
  56. It is intended for fonts which don't have separate files for italic and
  57. bold italic flavours. Here is an example for Tahoma:
  58.  
  59. FAMILYNAME Tahoma
  60. REGULAR    TTFonts:Tahoma.ttf
  61. BOLD       TTFonts:TahomaBold.ttf
  62. ITALIC     SHEAR TTFonts:Tahoma.ttf
  63. BOLDITALIC SHEAR TTFonts.TahomaBold.ttf
  64.  
  65. SMOOTHSMALL and SMOOTHBIG - these two controls text smoothing (also
  66. known as antialiasing). It has been proven that font sizes from 10 to 20
  67. points (typically) are more readable when not smoothed. Especially
  68. TrueType fonts which have really good hinting engine.
  69.  
  70. Comments
  71.  
  72. You can place any full-line comments in the file starting a line with
  73. hash or semicolon. End-line comments are not supported.
  74.  
  75.  
  76.